When loading resources, Rational Software Architect RealTime Edition (RSARTE) attempts to resolve references to other elements that are available in the workspace. If the target element for a reference cannot be found, the reference is said to be broken. Such broken references can, for example, result from refactorings that are done when not all affected models were present in the workspace. They can also occur because you have forgotten to import a project into the workspace, or have imported the wrong version of a project from your CM system (for example an old version which does not contain certain elements that are referenced from other projects).

 

In most cases RSARTE can cope with broken references, and you can resolve them later. However, some references are so important for the integrity of the model that certain features of the tool cannot work until they have been resolved. One example is the redefinition references inside an inherited state machine that must be resolved for the state chart editor to be able to render the state machine in a diagram. Therefore, RSARTE performs an automatic cleanup when model resources are loaded, so that elements that contain this kind of broken references are deleted. Because of this parts of an inherited state machine, or even the entire state machine, may be implicitly deleted when a model is loaded.

 

If automatic deletion of a model element takes place you will see a printout in the Console view (and this view gets focus to draw your attention to the problem). You should not then edit and save the model files where those elements were located. Because if you do, the elements will also be gone in the model file. Instead you should close the project which contains the affected model files, so that you won't modify them accidentally before the problem has been fixed. Then you need to resolve the broken references. Exactly how to do this depends on the reason for why they are broken. You may need to open a project in the workspace that was previously closed, or you may need to import a missing project (or a different version of a project that was already present in the workspace). When you think you have fixed the problem, so that the missing model elements now are present in the workspace, you can try to open the project that you closed previously. If all goes well you should now no longer get the message in the Console view about automatically deleted model elements.

 

There is a preference which can be set in order to disable the automatic deletion of model elements. It's called UML Development - Real Time - Resource Resolution - Broken references auto-cleanup. However, it's recommended to only turn this preference off if your ways of working ensures that you will manually correct all such broken references before you start to work with the loaded model.